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SECTION 4 
CLEAR/START AND MEMORY DUMP PROCEDURE 


The CLEAR/START program is a stand-alone utility that is used to bring a B 1000 system to an 
operable state. The process has three parts: (1) bootstrapping: loading the CLEAR/START program 
from the cassette into system memory, (2) clear/starting, performed by the CLEAR/START program 
itself, and (3) system initialization, performed by the SYSTEM/INIT program. This program is brought 
into memory from disk at the appropriate time by the CLEAR/START program. 


Execution of the CLEAR/START program is required after any of the following events: 


e Execution of the COLDSTART/DISK or COLDSTART/TAPE programs. 

e A system power-up; to start a day, for example. 

e A system failure that results in an irrecoverable system loop or system halt. 

e Execution of another stand-alone program such as PACK/INIT, DISK/DUMP, or 
STANDALONE/DISK-DUMP. 

e Certain of the system software changes that can be specified by the CM system command. 

¢ Setting or resetting of any of the following options: FLMP, MPRI, LOG, THR, VLCP, VLIO. 

e A change in the size of the Interpreter Dictionary specified by the IC system command. 


CLEAR START FUNCTIONS 
The CLEAR/START program performs the following functions: 


1. Dumps a copy of main memory to the disk file SYSTEM/DUMPFILE when a memory dump 
is requested. 

2. Clears main memory, writing zeros and correct parity throughout. 

3. Scans the I/O subsystem to locate the system disk. 

4. Saves certain registers and toggles that specify temporary environment changes for the 
SYSTEM/INIT (system initializer) program. 

5. Loads the SYSTEM/INIT program into memory from the system disk. 

6. Turns control over to the SYSTEM/INIT program. 
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SYSTEM INITIALIZATION FUNCTIONS 


After receiving control from the CLEAR/START program, the SYSTEM/INIT program performs the 
following functions: 


i’ 
2. 
3. 


5. 
6. 


Supplements the information in SYSTEM/DUMPFILE, when a memory dump is requested, by 
adding (copying) certain MCPII structures such as the Name Table and the ODT Queue. 
Allocates space for the initial structures in memory required for MCP operation, such as the 
Interpreter Dictionary and the MCP Stacks. 
Loads the GISMO program into memory from the system disk, builds the Interpreter Diction- 
ary entry for GISMO, and discards all GISMO segments not required because of the system 
hardware configuration, or because certain MCP options (such as MPRI) are not set. 


. Loads segment zero (non-overlayable) and segment one (overlayable initialization routines) of 


the MCPII into memory from the system disk, and sets up the initial memory link structures 
required. 
Loads segment zero of the SDL2 Interpreter into memory from the system disk and builds the 
required Interpreter Dictionary entry. 

Turns control over to the MCP. 


MCP FUNCTIONS 


When the MCP receives control from the SYSTEM/INIT program, a number of operations are per-_ 
formed before the system is actually ready to begin program execution. The MCP performs the fol- 
lowing routines as part of system initialization: 


1. 


~1 ON 


Tests the I/O subsystem to determine the system configuration. The Input/Output Assignment 
Table (IOAT), constructed from this information, contains entries that describe the characteris- 
tics of all peripheral units present on the system. 


. Constructs the initial chain of DISK I/O descriptors, as well as TEST I/O descriptors for all 


other peripheral units present on the system. 


. Restores entries in the Temporary Disk Available Table to the Working Available Table. 
. Reads the disk directory and every disk file header (DFH) present on the system disk, clearing 


the user count in any DFH that was in use prior to the CLEAR/START. Disk files marked 
as TEMPORARY (such as compile and go code files) are removed from the disk directory. 


. Places entries identifying the CLEAR/START in the SYSTEM/LOG (if the LOG option is set) 


and the SYSTEM/ELOG. 


. Initiates the SYSTEM/ODT program and, if the AMCS option is set, the MCS program. 
. Displays the CLEAR/START message on the operator display terminal (ODT), and then makes 


the system available for use. 


CLEAR/START OPERATING INSTRUCTIONS 


Three sets of procedures for performing the CLEAR/START operation follow. The first procedure is - 
for B 1990 systems with a console cassette drive. The second procedure is for B 1990 systems with a 
console diskette drive. The third procedure is for all other B 1000 systems. 
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SECTION 9 
CREATE/ISAM 


The CREATE/ISAM program creates and recovers COBOL74-type ISAM data files as well as converts 
COBOL74-type ISAM files to standard data files. 


An ISAM file can be created from a standard data file. 


Using an existing ISAM file as the input file, the data portion of that file can often be recovered. New 
GLOBAL and KEY files are produced and records marked for deletion in the existing ISAM file are re- 
moved in the output file. 


The data portion of an ISAM file can be converted to a standard data file. 
The output file attributes for disk (MAXRECSIZE, RECORDS.PER.BLOCK, BLOCKS.PER.AREA 
and AREAS) are the same as for the input file. (Refer to Tape Output for tape attributes.) 


Operating Instructions 


The CREATE/ISAM program accepts file specifications from cards, the ODT, or remote terminals. Pro- 
gram switches 2 and 3 are used to specify the input interface. 


Program Switch: 2 3 input 
0 0 terminal (default) 
0 IF ODT 
L* 0 cards 
| Ga i cards 


1* means any setting except 0. 


Setting switch 5 to a non-zero value allows the output data file ISAM or standard) to grow to 105 areas 
(the system maximum). When switch 5 is set to 0 (zero), the maximum number of areas is the same as 
that of the input file or 25, whichever is greater. 


The following input string is used to initiate execution: 
EXECUTE CREATE/ISAM 


The switch settings may be entered with the SWITCH control attribute or after the job has gone 
to BOJ, by means of the SW system command. (See B 1000 Systems System Software Operation 
Guide, Volume 1.) 
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Terminal Interface 


Unless the default settings for program switches 2 and 3 have been changed to request other than the re- 

mote terminal interface, the file screen shown in figure 9-1 is displayed at the terminal following the BOJ 
message. 

INPUT FILE SPECIFICATIONS 

NAME - PACK ID EMPTY IF FILE |S ON DEFAULT PACK 


MULTI-FILE ID 


[ ss on ee | 


C 
[ 
FILE !D [ 
[ 


DATA FILE PACK ID EMPTY IF DATA FILE SPECIFIED ABOVE 


OR DATA FILE IS ON DEFAULT PACK 
OUTPUT FILE SPECIFICATIONS 


NAME - PACK ID [ ] EMPTY IF FILE 1S ON DEFAULT PACK 
MULTI-FILE ID [ ] 
FILE ID ] 

|/S DATA FILE PACK ID [ ] EMPTY IF FILE 1S ON DEFAULT PACK 


NON-ISAM (DATA) FILE OUTPUT [ ] 
FOJ £ J 


‘Figure 9-1. File Screen 
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File Screen Semantics 


The file screen is used to enter the desired input and output file names and their locations. The input 
file must be on disk but can reference one of the following sources: 


1. The global (cluster) file of an existing COBOL74-type ISAM file. 

2. The data portion of an existing COBOL74-type ISAM file. 

3. A sequential file of type data (except when the NON-ISAM option is specified). 
DEFAULT PACK refers to (1) the System pack or (2), if the program is under a user code, to the 
default pack for that user code or (3), if the multi-file-id is a user code, to the default pack for that 
user code. 


When an ISAM file is being created (the NON-ISAM option is not specified), the newly created ISAM 
output file must be directed to disk and adhere to the following naming conventions: 


1. The specified OUTPUT FILE ID becomes the name for the new global file. 
2. The data and index files are assigned names as follows: 


FILE ID [MYFILENAME] 


global file name MYFILENAME 
data file name OOMYFILENA 
primary key index file name OIMYFILENA 
Ist alternate key index file name O2MYFILENA 

e e 

e e 

e e 


19th alternate key index file name 20MYFILENA 


3. The output ISAM data file must not have the same name as the explicitly or implicitly specified 
input data file. 

4. DISK may be used in the PACK ID fields to mean the system disk. This will override any de- 
fault packs. 


If the information entered through the file screen contains errors, the file screen display reappears with 
error messages. If no errors occur and the NON-ISAM (DATA) FILE OUTPUT field is not marked, the 
key screen (figure 9-2) is displayed. 
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CREATE/ISAM 
KEY DESCRIPTION (S) 
START LOCATION (BYTES) ALLOWED KEY oD 
01 Cc ] c Cd Eds J 
02 c J ae C J Ea. <f J 
03 c J Cc J C ] Cc] C i 
O4, c J cb al C J Ed} ke J 
05. tC. a ct .k ‘Ed Cl] J 
MORE KEY DESCRIPTIONS REQUIRED CJ 


FILE [ ] KEY [ ] EOJ [ J 
Figure 9-2. Key Screen 


Key Screen Semantics 
The key screen is used to enter the access key specifications for the resulting ISAM file. 


Entries for START LOCATION and LENGTH fields are right-justified. When entering data in these 
fields, SKIP TAB is used to position the cursor into successive fields. START LOCATION refers to 
the location of the first byte of the key field in the record description. The sum of the START LOCA- 
TION and LENGTH entries must be less than or equal to the data file record size. If both START 
LOCATION and LENGTH are blank, the program assumes that all keys have been entered. 


Entering a non-blank character in the DUPS ALLOWED field specifies that duplicates are allowed for 
the key. Any alternate key may have duplicates. 


Entering a non-blank character in the PRIME KEY field specifies that the key is the prime access path. 
Any key can be the prime key but the prime key must not contain duplicates. 


The access key files may be located on any pack. The entry “DISK” in the PACK ID fields is assumed 
to mean the System disk. This overrides any default packs. 


Each file screen allows five keys to be entered. If more keys are required, enter a non-blank character 
in the MORE KEY DESCRIPTIONS REQUIRED box. A total of 20 keys (1 prime, 19 alternate) are 
allowed. 


The functions specified by the entries at the bottom of the screen (FILE, KEY, EOJ) are activated 
by the entry of a non-blank character. 


FILE Return to file screen. All file names and 
keys must be re-entered. 


KEY Return to key screen. All keys previously 
entered are cleared and must be re- 
entered. 


EOJ Terminate the program. 
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ODT Interface 


The ODT interface allows the user to enter the program specifications as AC or AX commands in re- 
sponse to the MCP ACCEPT mechanism. This interface is activated when program switch 3 is set 
(non-zero). 


Specifications are entered in a free-field format. The program accepts commands until a blank or a null 
string is entered with an AC or AX command. The program accepts a maximum of 160 characters per 
command. One ISAM file or standard data file is created with each execution of the CREATE/ISAM 
program. KEY specifications are not valid if the NON-ISAM option is specified for the output file. All 
limits described in the terminal interface apply to the ODT interface. 


Syntax (ODT Interface): 


<ODT interface> 


< file syntax > a i < key syntax > ————__—_——_ 


<file syntax > 


— FILE < input specs > an < output specs > 
Poets < output specs > i a <input specs > 


<input specs> 


— IN (TITLE = <file title> ) 


DATA (FAMILYNAME = < family name> ) 


<output specs> 
—— OUT (TITLE = <file title> ) 


DATA (FAMILYNAME = < family name> ) 


NON-IS AM 


<file title> 


ON < family name> 
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nn —— OO —- YY Oooo? 


< file-name > 
< first name> 


* < first name > / < second name> 


(< usercode >) <second name> 


Semantics (ODT Interface): 


The characters usable in the preceding syntax are upper-case letters, numbers, underscores, and 
hyphens. 


<file-name> 
Used to reference a file without reeaed to its medium. 


<family name> 
One to ten characters. Name of disk or pack. The name DISK can be used to specify the System disk 
and overrides the default pack associated with a usercode. 


<first name> 
One to ten characters. When the asterisk syntax is used, the asterisk character counts as one of the 
ten characters in the < first name>. 


<second name> 
One to ten characters. 


<usercode> 
One to eight characters. 


* (asterisk) 
Used in a <file-name> to override the default usercode and the default Pack <family name> associ- 
ated with that usercode. It is only necessary to use an asterisk in a <file-name> when the program 
accessing the file is run iades a usercode and the < file-name> consists of a <first name> only. Use 
a <family name> of DISK to override the default pack. 


DATA 
Indicates that the following family name is that of the pack for the ISAM file. 


NON-ISAM 
Specifies that the output file is a standard data file. 


Syntax (<key syntax>): 


<key syntax> 


i ah nk 


| aa 
ma KEYS (< key specs > - ) 


oo PRIME Tl. J 
a “—~ ON < family name> — 
DUPLICATES —— 


<offset> <length> —_ 
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Semantics (<key syntax>): 


<key syntax> a 
This item is not used when the NON-ISAM option 1s specified. 


<offset> 
Refers to the relative displacement from zero of the first character of the key in bytes. 


<length> 
Refers to the length of the key in bytes. 


NOTE 
Keys are alphanumeric; each character is one byte. 


ODT Interface Sample Executions 
Two sample program control instructions follow: 


EX CREATE/ISAM SW3 1 
<mix-number>AX FILE IN (TITLE=ACCOUNTS/PAYABLE ON USER), 
OUT (TITLE=ACCOUNTS/PAYABLEX), DATA (FAMILYNAME = USER), 
KEYS (4 5 PRIME) (20 10 DUPS) (32 5 ON USER2) 
EX CREATE/ISAM;3AX FILE IN (TITLE=(usercode) MASTER ON PACKX) 


OUT (TITLE= (usercode) NEWMASTER) 
KEY ( 1. 10 PRIME) 


Card Interface 


The card interface allows the user to enter the program specifications through the card reader. This inter- 
face is activated when program switch 2 is set (non-zero). 


Specifications entered in this interface are free field and the program can accept up to eighty (80) charac- 
ters of data per card. 


All limits described in the terminal interface and the ODT interface apply in the card interface. 


The syntax for the card interface is identical to that given for the ODT interface. 


Tape Output 


When the NON-ISAM option is specified, a standard data file is created which can be file equated to 
tape. The output MAXRECSIZE and RECORDS.PER.BLOCK are acquired from the input file. The 
file equate is as follows: 

EX CREATE/ISAM FILE DATAOUT TAPE 
where DATAOUT is the standard data output file in the CREATE/ISAM program. 
The tape label is either <multi-file id> /<file id> or just <file id> (if no multi-file id is entered). The 
data tape can be read by the A Series SYSTEM/DUMPALL and B 1000 DMPALL programs. 


Output Messages 
Error messages and informative procedural messages are displayed by the CREATE/ISAM program. 


When these messages appear is slightly different depending on which interface is being used to enter the 
input specifications. 
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Terminal Interface Messages 


When all specifications have been accepted by the CREATE/ISAM program, the following message is 
displayed: 


BEGIN COPY OF <input-file name> TO <file type> <output-file name> 
where <file type> is ISAM FILE or DATA FILE. 
The following message is displayed every 1000 records and when the copy is complete: 


<number> RECORDS COPIED 


If errors occur during the copy operation, a message is displayed. Depending on the nature of the er- 
ror, program execution may be continued or terminated. 


ODT Interface Messages 


If errors occur in the syntax of the <ODT interface> entries, error messages are displayed after each 
AC or AX command entry. A blank AC or AX command must be entered before the errors can be 
corrected. Two successive blank AC or AX commands cause the program to terminate. 


The copy operation does not begin until after the syntax is error-free and one blank AC or AX com- 
mand has been transmitted. Errors that occur during the copy operation are displayed as they occur, 
with appropriate messages. 


Error Conditions 


Errors associated with the file screen or the key screen cause the screen to be re-displayed with the 
user’s input in place and self-explanatory error messages displayed at the bottom of the screen. 


Errors during the file copy are displayed when they occur. Depending on the error, the program may 
continue or terminate. For error conditions in this category, the messages displayed, the causes, and 
the actions to take are as follows: 


*** WRITE ERROR 1 — UNEXPECTED END OF FILE, RECORD NUMBER N. 
The MCP returned an end-of-file condition which indicates a system failure of some type. The 
program terminates. 


*** WRITE ERROR 2 — DUPLICATE KEY, RECORD 

NUMBER N, ENTER "OK” TO IGNORE RECORD AND CONTINUE. 
This condition is typically caused by a duplicate key in a field where duplicates are not al- 
lowed. If the error is entered with an AC or AX command, the program hangs, but resumes 
if AX OK is entered. Otherwise, the program terminates. 


*** WRITE ERROR 6 — REQUESTED AREA IS GREATER THAN FILE 
ALLOWS, RECORD NUMBER N. 


This condition indicates the failure of the 


n 
awRews a aan vv ean v 


tions. The program terminates. 
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Semantics: 


ADDRESS | 
Causes printing of the port, channel, and adapter numbers to which the data communications I/O 


descriptor was dispatched. 
This is a default parameter. (NO.ADDRESS is the negation.) 


ALL.LINES 
Causes printing of all audit file records from all data communications lines. 


This is a default parameter. (LINE permits selection; DEL.LINE permits dynamic deletion.) 


BDLC 
Causes printing of the text data and the result descriptors that are associated with the data commu- 
nications I/O descriptor. Printing is in hexadecimal format for easy interpretation by BNA and 
SNA users. 


Default: Do not print in hexadecimal format. 


BUFFERS 
Causes printing of the text data that is associated with the data communications I/O descriptor. 


This is a default parameter. (NO.BUFFER is the negation) 


DEL.LINE= <pp:cc:aa,pp:cc:aa,...> 
This parameter may be entered while the DC/AUDIT program is executing to stop the monitoring 
of selected lines. Entries are made in the same way as is shown for the LINE parameter later in 
this list. 


Default: Not applicable. 


DISPATCH.BIT 
Causes the output to specify which of the following two ways was used to dispatch an operation: 
(1) by network controller dispatch of the I/O descriptor, or (2) by resetting the operation-complete 
bit of the data communications I/O descriptor. 


Default: NO.DISPATCH 


DOUBLE 
Causes double spacing of the records in the output listing. 


Default: SINGLE 
ERROR= <n> 
The value given to <n> specifies the way records that contain indications of data communications 


errors are printed. (Note that there are no spaces between the parameter name, the equal sign, 
and the value.) 


ERROR=!I causes printing of all audit records in the audit file. (This is the default condition.) 
ERROR=2 causes printing of only the audit records that completed without exceptions. 
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ERROR=3 causes printing of only the audit records that completed with exceptions. 


ERROR = aaaaaa provides a hexadecimal mask (aaaaaa) to use for searching result descriptors for 
records to print. The mask is converted to a 24-bit binary representation that is used to specify 
the operation to monitor. The bits are numbered 0 through 23 (high order to low order). If the 
bit that matches a list item is reset (0), the corresponding operation is not monitored; if the bit 
is set (1), operation is monitored. 


Bit Description 

0 Operation complete. 

1 Exception. 

2 Reserved. 

3 Parity error on read. 

4 Memory access error on read. 
5 Memory access error on write. 
6 Timeout. 

7 Break received during a write. 
8 No ending control character received. 
9 Linking terminated. 

10 Reserved. 

11 Loss of data set ready. 

12 Loss of carrier. 


13-24 Reserved. 


Defauit: ERROR =i. 


HEADER 


Causes column headings to be printed at the top of each page. 


This is a default parameter. (NO.HEADER is the negation.) 


IO.DESC= <n> 


The value given to <n> specifies the printing format of the data communications I/O descriptor 
field. (Note that there are no spaces between the parameter name, the equal sign, and the value.) 


IO0.DESC = 1 causes the descriptor to be printed in hexadecimal format with a blank between each 
of its fields. 


IO.DESC =2 causes the descriptor result field to be interpreted as a mnemonic and printed. If 
more than one exception condition has occurred, only the first exception is printed. 


Default: IO.DESC =2 


LENGTH = <n> 
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<n> signifies a decimal number one to four characters long. The value given to <n> specifies 
the printing of the length of the buffer in bytes. (Note that there are no spaces between the param- 
eter name, the equal sign, and the value.) 

Example: LENGTH = 400. 


Default: Length is the entire buffer. 
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NO /SATTINTT 
Ve/AULMIL 


aaaaaaa 
Type of I/O operation. 


data 
Data written or read. If OUTPUT=A, data consists of graphics, special line control characters 
with their names enclosed in broken brackets (< >), and non-graphics with each 4-bit group in 
hexadecimal representation enclosed in brackets ({]). The characters ”[” and ”]” are treated as non- 
graphics. | 


Example: <STX>[EC]JABC12<ETX> 


If OUTPUT=H, then each 4=bit group of data is in hexadecimal representation. 
Example: 01ECC1C2C3F1F2203 


pp:cc:aa 
Port, channel, and adapter to which the I/O descriptor was issued. (Included if ADDRESS param- 
eter is set.) 


bbbbb 
Appears if the DISPATCH.BIT parameter is set. If I/O was initiated by resetting the I/O com- 
plete bit, RESET is printed. If I/O was initiated by a dispatch communicate to the MCP, DIS- 
PATCH is printed. 


LENGTH = nnnn 
The length of the data read or written. 


ccccc 
The mnemonic interpretation of the manner in which the I/O operation completed. Refer to the 
subsection of this manual titled I/O Completions for a complete description of the completions. 
Output Format 2 


Output format 2 is generated when default parameters IO.DESC=2 and NO.BUFFERS are both 
specified. If the HEADER parameter is specified; the header format of each page is as shown in the 
upper part of figure 11-2. Records from the audit file are printed in the format shown in the lower 
part of figure 11-2. 
The field descriptions given for output format 1 are valid for output format 2. 

kkeee B 1000 DC/AUDIT <date and time> *x#xxx 

TIME OP RESULTS 


Header Format 
hh:mm:ss.t aaaaaaa pp:cc:aa bbbbb LENGTH=nnnn = ccece 


Record Format 


Figure 11-2. Header and Record Formats, Output Format 2 
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Output Format 3 


Output format 3 is generated when the parameters IO. DESC =1 and BUFFERS are both specified. If 
the HEADER parameter is specified, the header format of each page is as shown in the upper part 
of figure 11-3. Records from the audit file are printed in the format shown in the lower part of figure 
11-3. 


Field descriptions for output format 3 follow the figure. 
water B 1000 DC/AUDIT <date time> *tkxx% 
TIME OP BUFFER DESCRIPTOR 


Header Format 


hh:mm:ss.t aaaaa data AE=xxxxxx RS=xxxxxx LK=xxxxxx OP=xxxxxx SA=xxxxx 
EA=xxxxxx MS=XXXXXX XXXKXX XXXXMX XXXXXKX XXXXXK XX 
LENGTH=nnnn 
--->hexadecimal representation of 1/0 descriptor<- 


Record Format 


Figure 11-3. Header and Record Formats, Output Format 3 


Each item or field is described as follows: 


hh:mm:ss.t 
Time in hours, minutes, seconds, and tenths. For a read, time represents read completion time; 
for all other operations, time represents start time. 


aaaaaaa 
Type of I/O operation. 


data 
Data written or read. If OUTPUT=A, data consists of graphics, special line control characters 
with their names enclosed in broken brackets (< >), and non-graphics with each 4-bit group in 
hexadecimal representation enclosed in brackets ([]). The characters ”[” and "]” are treated as non- 
graphics. 


The actual ending address of the descriptor. 


RS 
The result descriptor. 


LK 
The link address to the next descriptor. 


OP 
The operation code. 


SA 
The start address of the descriptor. 
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COMMANDS 


The DMPALL program commands are CAT (concatenation), COPY (or PERFORM), LIST, and PD 
(print directory). These commands and their functions are described in detail in the following pages. 
The various specifications referred to in the command semantics are all grouped under Specifications, 
following the PD command. 


CAT (Concatenation) Command 


The CAT command concatenates files. Records from any card, magnetic tape, paper tape, or disk file 
can be copied to the end of a specified disk file, called the base file. The base file is opened, and 
the specified concatenation file records are added to the base file; when the base file is closed, the 
end-of-file (EOF) pointer is updated to include the new records. If the concatenated file size exceeds 
the size limit of the base file, and if both the concatenation and the base files are disk files, then the 
DMPALL program copies the base file, enlarging it, and then adds the concatenation file. Likewise, 
if the base file is crunched, the DMPALL program copies the base file before performing the conca- 
tenation. If both files are not disk files, the operator must ensure that the concatenated file does not 
exceed the file size limit of the base file. The CAT command is not allowed with ISAM data files. 


Syntax: 


A ye |e 


z DSK <concatenation-file-hardware-type> OT 
DISK ae < concatenation-file-hardware-type> 
TO 


L__.. < eoncatenation-file-title > —+ =“ <concatenation-file-access-mode>> —— 


< concatenation-record-length > < base-file-access-mode > 


<blocking-factor > 


VARIABLE 
VARY 


TAG: <tag-file-title> <base-file-title > <options> 


Semantics: 


base-file-title a = 
This specifies the namie of the file (base file) to append the <concatenation-file-title> file. Refer 
to <file-title> Specification for the syntax and semantics of <base-file-title>. 


blocking-factor 
This field specifies the number of records per block for the file and must be numeric. If <block- 
ing-factor> is not specified, it defaults to 1. For disk and labeled B 1000/B 6000/B 7000 tape 
files, when both <concatenation-record-length> and <blocking> are not specified, the value of 
<blocking-factor> defaults to the value contained in the label record. 


1169091-002 16-5 


B 1000 Systems System Software Operation Guide, Vol. 2 
DMPALL 


concatenation-file-access-mode 
This field specifies the recording mode of the concatenation file. Refer to <access-mode> Specifi- 
cation for the syntax and semantics. 


concatenation -file-hardware-type 
This field specifies the hardware type of the concatenation file. Refer to <hardware-type> 
Specification for the syntax and semantics. 


concatenation-record-length . 
This field specifies the size of each record, in bytes, and must be numeric. If <concatenation- 
record-length> is not specified, it defaults to 80 bytes, except for disk and labeled 
B 1000/B 6000/B 7000 tape files, where <concatenation-record-length> defaults to the record size 
of the file in the label record. 


concatenation-file-title 
This field specifies the name of file 11 which to append to the end of the <base-file-title> file. 
Refer to <file-title> Specification for the syntax and semantics of <concatenation-file-title>. 


DISK 
The DISK keyword specifies that the hardware type of the input file is a disk file. 


DSK 
The DSK keysymbol specifics that the hardware type of the input input is a disk file. If DSK is 
specified, then there can be no blank character between the DSK keysymbol and the <concatena- 
tion-file -hardware-type> spevification. 


options 
Refer to <options> Specification for the syntax and semantics. 


TAG: 
The TAG: keysymbol specifies that the file to be listed is the tag file of <tag-file-title>. This 
applies to the B 1000 ANSI 68 COBOL RPGII index ($ TAG) files. The tag file must be created 
with the B 1000 ANSI 68 COBOL or RPGII naming conventions. The tag file specified is read 
sequentially, and the key field of each. tag record is used to access the associated indexed file rec- 
ord. 


tag-file-title 
Refer to <file-title> Specification for the syntax and semantics. 


TO 


The TO keyword is optional and specifies that the <concatenation-file-hardware-type> specifica- 
tion follows. 


VARIABLE 
The VARIABLE keyword specifies that the input file is a variable-length record file. 


VARY 
The VARY keyword specifies that the input file is a variable-length record file. 
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Pragmatics: 


When concatenating files, the base file must be a disk file. The concatenation file can have any input 
hardware device; LIST (printer) is not a valid input device. 


The <concatenation -record-length> and <blocking-factor> options are specified in the same manner 
as the <record-size> and <blocking> options in the LIST command. If the record length of the 
concatenation file is larger than the record length of the base file, then the concatenation file records 


wVihiw MAULLWAL ARbY 20 2A pew saw twee Awe 


are truncated when they are added to the base file. The <base-file-title> file must name an existing 
disk file. 


A record size and blocking factor cannot be specified for the base file. These values are taken from 
the disk file header of the base file. 


Examples: 


CAT DSKDSK HISTADDS 180 1 HISTORY 
CAT DISK TO TAPE APPENDIX 90 20 MANUAL SKIP 4 


COPY (or PERFORM) Command 
Records can be copied from any card, magnetic tape, paper tape, or disk file to any output file desired. 
Various file attributes, including record sizes, blocking factors, and file-identifiers can be changed dur- 


ing the copy process. It is also possible to select certain records from the input file to be copied, based 
on specified conditions. The COPY command is not allowed with ISAM data files. 


Syntax: 


—T1— COPY 


PERFORM a a <routine-type > J F < input-file-title > is < input-access-mode > 2 
“NONE” 


VARIABLE 


< input-record-length > < output-access-mode > 


< input-blocking-factor > VARY 


L TAG: <tag-file-title > i a < output-file-title > J 
Le< output-record-length > | See a < options > a 
< output-areas-and-blocking > 
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Semantics: 


"NONE" 
The "NONE” keyword specifies that the file to list is an unlabeled tape file. The double quotation 
mark (") characters are required. 


input-access-mode 
This field specifies the recording mode of the input file. Refer to <access-mode> Specification 
for the syntax and semantics. 


input-blocking-factor 
This field specifies the number of records per block for the file and must be numeric. If <input- 
blocking-factor> is not specified, it defaults to 1. For disk and labeled B 1000/B 6000/B 7000 
tape files, when both <input-record-length> and <input-blocking-factor> are not specified, the 
value of <blocking-factor> defaults to the value contained in the label record. 


input-file-title 
This field specifies the name of the input file to copy. Refer to <file-title> Specification for the 
syntax and semantics. 


input-record-length 
This field specifies the site of each record, in bytes, and must be numeric. If <input-record- 
length> is not specified. it defaults to 80 bytes, except for disk and labeled B 1000/B 6000/B 7000 
tape files, where <input-record-length> defaults to the record size of the input file in the label 
record. 


options 
This field specifies the DMPALL o,tions to skip or include records, to exclude, search, or select 
records based on specified conditions, or specify that the input file is a variable-length record file. 
Refer to the <options> Specification for the syntax and semantics. 


output-access-mode 
This field specifies the recording mode of the output file. Refer to <access-mode> Specification 
for the syntax and semantics. 


output-areas-and-blocking . 
This field specifies the blocking factor, blocks per area, and number of areas for the output file. 
Refer <output-areas-and-blocking> Specification for the syntax and semantics. 


output-file-title 
This field specifies the name of the output file. Refer to <file-title> Specification for the syntax 
and semantics. 


output-record-length 
This field specifies the length in bytes ;‘or the output file. If omitted, the record length defaults 
to 80 bytes, unless both the inpui and output files are either disk files or labeled 
B 1000/B 6000/B 7000 tape files. In this case, <output-record-length> is assumed to be the same 
as the <input-record-length>. 
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< output-areas-and-blocking > Specification 


The <output-areas-and-blocking > Specification describes the blocking factor, blocks per area, and the 
number of areas for the output file. 


< blocking factor > > ——_— << 
_ 1 
< blocks-per-area > 


Syntax: 


< number-of-areas > 


Semantics: 


blocking-factor 
This field specifies the number of records per block for the file. If omitted, a blocking factor of one 


is assumed. If both the input and output files are either disk files or labeled B 1000/B 6000/B 7000 
tape files and the <output-record-size> is omitted, the <output-blocking-factor> is assumed to be 


the same as the <input-blocking-factor>. 


blocks-per-area 
This field specifies the number of blocks per area for disk files only. If omitted, 100 blocks per 


area is assumed. If both the input and output files are disk files and both the <output-record- 
length> and <output-blocking-factor> are omitted, the <blocks-per-area> is assumed to be the 


same as the blocks per area of the input file. 


number-of-areas 
This field specifies the number of disk areas for disk files only. If omitted, <number-of-areas > 


defaults to 25. If both the input and output files are disk files and the <output-record-length>, 
< output-blocking-factor>, and <blocks-per-area> are omitted, <number-of-areas> is assumed 
to be the same as the number of areas assigned to the input file. 


116909 1-002 16-21 


B 1000 Systems System Software Operation Guide, Vol. 2 
DMPALL 


<routine-type> Specification 


The media types for the input and output files for the COPY (PERFORM) command are selected from 
the <routine-type> Specification. The medium specified first in the string pertains to the input file; 
the second pertains to the output file. 


Syntax: 
BINARY BINARY 
CASS CASE 
CARD CARD 
CARD96 = CARDQS =a 


H 


DISK = —— DISK ——— 


MULT!|-— 


List —— 

: | 
PAPER —— MULT! —— 
TAPE —— PAPER —— 


TAPE7 7 TAPE ——— 
Tapsg —— 


TAPE? —— 


eG 


TAFEQ —— 


til 


Pi Ltt : 


Pa oe a: 
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Semantics: 


BIN 


BINARY 
CAS, CASS 


CASS 
CARD 


CARD96 
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The BIN (or BINARY) keyword specifies that the hardware 
type is a binary card file. The card file is assumed to be 80- 
column and a card with END-OF-DECK punched in columns 
1 through 11 must be the last card in the deck. 

See BIN. | 

The CAS (or CASS) keyword specifies that the hardware 
type is a cassette file. 

See CAS. 

The CARD (or CRD) keyword specifies that the hardware 
type is a card reader file. 


The CARD96 (or CRD96) keyword specifies that the 


-hardware type is a 96-column card reader file. 


See CARD. 

See CARD96. 

The DISK (or DSK) keyword specifies that the hardware type 
is a disk file. 

See DISK 


www a7 eivane 


The LIST (or LST) keyword may be specified for an output 
It causes the file, without heading or record numbers, to be 
listed on the line printer. 


See LIST. 


The MPF (or MULTI) keyword specifies that the hardware 
type is a multi-pack disk file. 


The MTP (or TAPE ) keyword specifies that the hardware 
type is a magnetic tape file. 


The MT7 (or TAPE7) keyword specifies that the hardware 
type is a 7-track magnetic tape file. 


The MT9 (or TAPE9) keyword specifies that the hardware 
type is a 9-track magnetic tape file. 


See MPF. 


The PAPER (or PPT) keyword specifies that the hardware 
type is a paper tape file. 


See PAPER. 
See MTP. 
See MT7. 
See MT9. 
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Pragmatics: 


Notice that all keywords for <routine-type> are of two forms, a three-character short form and a 
greater-that-three-character long form. 


The short form must be entered in concatenated pairs only (no spaces). Examples: 


CRDMTP 
DSKMTP 


The long forms must be entered as pairs either separated by at least one space, or by the word TO 
with at least one space before and after it. 


Examples: 
CARD TO TAPE 
CARD TAPE 
DISK TO TAPE9 
DISK DISK 


If the <routine-type> option is omitted, both media (input and output) are assumed to be DISK. 


Text deleted by PCN-002 
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If all of the necessary structures on the disk are found to be valid and the previous initialization 
did not abort before it initialized the entire disk, the following prompt is displayed on the ODT: 


IS A PURGE DESIRED? <YES OR NO> 


A YES response causes the PACK/INIT program to prompt for SERIAL NUMBER, PACK ID, 
PACK TYPE, OWNER’S NAME and OPTIONS. The PACK/INIT program then does an 
initialization of cylinder zero, thus rendering inaccessible all data previously on the disk. Any fur- 
ther initialization is performed in response to CYLINDER NUMBER prompts. A NO response 
results in the initialization of cylinders specified in response to CYLINDER NUMBER prompts. 
The disk is not purged, and the program does not initialize any cylinder or range of cylinders that 
is in use (not entirely available). 


CV = Cylinder Verification 
Verify only those cylinders specified in answer to the CYLINDER NUMBER prompts, except cyl- 
inder zero, which is automatically verified. 


RR = Relocate and Reallocate 
This action is only offered for B 9494-5, B 9494-10, and B 9484-12 disks. It is used to relocate 
or reallocate (the reverse or undoing of a relocate) a single sector at a time. The sector may be 
in use and its data is retained, whenever possible. When this action is requested, the following 
prompt sequence ensues: 


Prompt: A SECTOR CAN BE RELOCATED TO A 
SPARE OR 
REALLOCATED FROM A SPARE 


ENTER <SECTOR ADDRESS> TO 
RELOCATE, ”—” 

<SECTOR ADDRESS> TO 
REALLOCATE 


WHICH SECTOR (BLANK TO QUIT)? 


Response examples: 


1000 
@0003E8 @ 

— 1000 

— @0003E8@ 


The first two examples cause sector 1000 to be relocated; the next two cause it to be reallocated, 
if it is found to be relocated. Entering a blank input terminates the RR action. 
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FC = Factory Convert 
This action is only offered for B 9494-5 and B 9494-10 fixed disks that are in the interlaced format 
written by the factory. It converts the factory Interchange format to the B 1000 native mode format 
and is used only once when the disk 1s first installed. The prompt sequence asks for the PACK TYPE 
and OWNER’S NAME. This action cannot be selected and is not offered for a disk that is not of 
the correct type, is formatted as a sequential disk, has an unreadable or invalid label, or has already 
had an FC performed on it. 
NOTE 

The actions RR, RC, RI, CI, and CV are valid only when processing a disk 

that has previously been initialized with the Mark 8.0 or later version of the 

SYSTEM/DISK-INIT or PACK/INIT programs and the disk label, Master 

Available Tables, and Relocate Table are intact and valid. 


SERIAL NUMBER 


The SERIAL NUMBER message requests a six-digit decimal number to be used on a new or purged 
pack to identify the disk. This number must be non-zero and should be unique to avoid confusion. 
Note that the MCP does not allow two User disks with the same serial number to be on-line at the 
same time. 


Prompt: ENTER 6 DIGIT SERIAL NUMBER 
PACK ID 


The PACK ID message requests a name that is assigned to the disk, using 10 characters or less and 
containing no embedded blank characters. The system uses this name to reference the disk. When input 
specifications are entered from cards, omitting this entry causes an error for pack-type. If the disk is 
a User disk, the reserved name DISK is not allowed. 


Prompt: ENTER PACK ID 
PACK TYPE 
The PACK TYPE message requests the type of use this disk will be dedicated to until the next 
initialization. The type is specified by a one-letter abbreviation of the allowable pack types, which are 
User (U) or System (S). 

Prompt: ENTER PACK TYPE — <U OR S> 
DATE 


The DATE message requests the current date in Julian date format. A Julian date is a five-digit field, 
with two digits for the year followed by three digits for the absolute day of the year, for example; 
84256. 

Prompt: ENTER 5 DIGIT JULIAN DATE (YYDDD) 
OWNER’S NAME 


The OWNER’S NAME message requests an optional 14-character field available to identify the person 
responsible for maintaining the disk. The system does not reference this field. 


Prompt: ENTER OWNER’'S NAME 
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Execution Of The RD Program (With SMCS) 


When the RD program is executed in conjunction with the SMCS program, the RD program can be 
automatically executed by the SMCS through the SMCS job-spawning facility. This can occur when 
the first terminal user signs on or passes to the RD program from a local terminal or when the AUTO- 
START option is specified in the SMCS JOBS file. In either case, the RD program does not have to 
be executed through the system ODT. 


The remote file for RD program is labeled RMT and uses PROTOCOL TYPE 2 as defined by the 
SMCS program. PROTOCOL TYPE 2 provides the RD program with the usercode, password, user- 
code index, and station signal character for a user at a terminal when the user passes commands to. 
the RD program by way of the SMCS program. 


Any PASS input command through the SMCS program to the RD program causes the RD program 
to apply the usercode/password to file identifiers unless the asterisk (*) character convention is used 
to override the usercode. Therefore, if a user is logged on to the SMCS program, a PASS RD of any 
directory-search command, such as PD, KA, BF, or DF for a single-name file that is not under the 
usercode of the user must be preceded with an asterisk (*) character. For example, entering PASS RD 
PD MCPII causes the RD program to search the disk directory for a file labeled (usercode)/MCPII, 
but entering PASS RD PD *MCPII causes the RD program to search the system disk directory for 
MCPII. If the usercode has a default family name, the RD program searches that disk for the file 
identifier. 


Termination Of The RD Program 


When the RD program is running, the BYE or EOJ command can be used to bring the RD program 
to an orderly termination. 


The BYE command sends the RD program to end of job if there are no other users signed on to the 
RD program and if program switch $ is equal to 0. 


The EOJ command sends the RD program to end of job if the EOJ command is entered from one 
of the following sources: 


1. The only station signed on to the RD program. 

2. A station that uses the PASS RD EOJ command by way of the SMCS program, if there are 
no other stations signed on to the RD program. 

3. The system. ODT, by means of the MCP ACCEPT mechanism; for example, by entering 
<RD mix number > AX EOJ 
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Terminal Commands 


The RD program commands that are entered from remote terminals are described in this section. Syn- 
tax diagrams are included for all commands except those that consist of a single term only. 


Commands that produce screen outputs greater than 22 lines provide SKIP prompts on the first line to 
view the next screen. These prompts are only provided while operating in the PASS mode. The prompts 
are not required when the user is signed on to the RD program. 


AVL (Available Disk) 


The AVL command causes the RD program to display the available disk areas on the specified disk. 
If a family name of DISK is specified, the system disk is searched for available disk areas. | 


Syntax: 


PN oo 


Example input: 


AVL DISK 


Example output: 


AVAILABLE DISK SUMMARY: 
NUMBER OF CHUNKS & 


LARGEST CHUNK 89842 
TOTAL SPACE 127138 
TEMPORARY AREAS SUMMARY: 

NUMBER OF CHUNKS 76 
LARGEST CHUNK 3060 
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Syntax: 
— KA 
< file identifier > SUMMARY < skip/page > 
DSKAVL 
Semantics: 
DSKAVL 


Displays the available disk space on the specified disk in two categories: available disk space and 
space that is in use temporarily. The summary for each category includes the number of areas, 
the size of largest area, and the total space available or in temporary use. 


To obtain these statistics while logged on to the SMCS program and/or the RD program, an aster- 
isk (*) must prefix the DSKAVL option. 


Examples: 


KA *DSKAVL 
KA USERPACK/*DSKAVL/ 
SUMMARY 
Displays the total number of files, the largest file, the total number of segments, records, and bytes 
and the average number of segments, records, and bytes for a family of files. 


KA = SUMMARY 


If logged on to the SMCS program and/or the RD program, the equal sign (=) character is valid 
and causes the RD program to give a summary of all the files for the usercode logged on. 


KA USERPACK/MASTER/= SUMMARY 
Produces a summary of all the files with a file name USERCODE/MASTER/ <file-name>. 
Example inputs: 


KA SYSTEM/F? 

KA USERPACK/(USER)/= PAGE 2 
KA DSKAVL 

KA MASTERFILE 

KA MASTERFILE/I? 

KA MASTERFILE/?I 

KA *DMPALL 

KA *MASTER/= SUMMARY 


1169091-002 22-21 


B 1000 Systems System Software Operation Guide, Vol. 2 
, RD 


Example output: 


xx NAME ** TYPE RSZR.B B.A S.A AREAS EQF CREATN UPDATE 
ODT .QUEUE DATA 180 1 200 200 a. 200 NODATE NODATE 
TRAINTABLE DATA 360 ] 3 74 i/o] 3 ae 120980 
BUILDTRAIN CODE 180 1 2 28 Vf] 28 1024 120980 
INIT.OLD INTP 180 1 59 86559 V/V] 59 081380 021381 
ODT CODE 180 1 209 209 lf 1 209 021781 031081 
ELOG LOG 180 1 100 100 7/ 25 700 032781 032781 
CONTROLLER CODE 180 1 423 423 1/1] 423 031781 033081 
NIF DATA a0 4 3 iy A 9 031781 033081 
BACKUP CODE 180 1 103 103 if +l 103 031181 033081 
COMPARE CODE 180 1 107 107 ie 107 031281 03308] 
FILE.INIT CODE 180 ] 37 37 lf ] 37 091879 120980 


KB (ODT Queue) 


The KB command causes the RD program to display the system ODT queue. Various KB command 
parameters can be specified for paging through the system ODT queue. 


Syntax: 
“= KB 
< integer > 
+ < integer > 
— <integer > 
BACK 
< integer > 
Semantics: 
< integer > 


Causes the RD program to start listing the ODT queue from the segment number specified by <in- 
teger>. Valid entries for <integer> range from 0 to 1023, inclusive. 


+ <integer> 
Causes the RD program to start listing the ODT queue from the (current + <integer>) segment. 


— <integer> 
Causes the RD program to start listing the ODT queue from the (current — <integer>) segment. 


BACK 
Causes the RD program to display one screen page back from the most recently displayed page 
of the ODT queue. The station must be signed on the RD program in order to use the BACK 
option. 
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Station Section 

The NDL MYUSE attribute must be set to INPUT, OUTPUT. The address is set to the address of 
the remote printer. 

~ Example: 


STATION APTERYX: 


TERMINAL = AP310 

RETRY = 10. 

FREQUENCY = 0,0. 

MYUSE = INPUT, OUTPUT. 
ADDRESS = "AP", 


Line Section 


The remote printer can be declared on a line with other terminals using the same line discipline. The 
line address is set to the address of the line containing the remote printer. 


Example: 
LINE APLINE: 
ADDRESS = 2.022. 
CONTROL = CANDETDCTL. 
STATION = APTERYX. 


File Section 


The remote file for the remote printer must be declared separately from the SMCS remote file, 
MCSREMOTE. Only one remote printer can be declared per remote file. 


The TITLE attribute of the REMOTE/PRINT file PRINTER should be modified to have the title of 
the remote file declared in the network controller. 


Example: 
FILE APFILE: 


FAMILY = APTERYX. 
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Example Network Controller 


TERMINAL AP310: 


TRANSMISSION) = 1. 

ADDRESS = 2. 

TYPE = 71. 

BUFFERSIZE = 2000. 

REQUEST = CANDEPOLTD: RECEIVE, 


CANDESELTD: TRANSMIT. 


STATION APTERYX: 


TERMINAL = AP310. 
RETRY = 10. 
FREQUENCY = 0,0. 
MYUSE = INPUT, OUTPUT. 
ADDRESS = “AP”, 
LINE APLINE: 
ADDRESS =) 2:02. 
CONTROL = CANDETDCTL. 
STATION = APTERYX. 
Text deleted by PCN-002 
FILE APFILE1!: 
FAMILY = APTERYX. 
Text deleted by PCN-002 
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If the disk has a bad label, Master Available Table or Working Available Table, or the operator 
specifies that the disk is to be purged, then cylinder 0 will automatically be initialized, thus purging 
the disk. 


If all of the necessary structures on the disk are found to be valid and the previous initialization 
did not abort before it initialized the entire disk, the following prompt is displayed on the ODT: 


IS A PURGE DESIRED? <YES OR NO> 


A YES response causes the SYSTEM/DISK-INIT program to prompt for SERIAL NUMBER, 
PACK ID, PACK TYPE, OWNER7S NAME and OPTIONS. It will then automatically initialize 
cylinder 0, thus rendering inaccessible all data previously on the disk. Any further initialization 
will be performed in response to CYLINDER NUMBER prompts. 


On a NO response, only those cylinders that were specified in response to CYLINDER NUMBER 
prompts are initialized. The disk is not purged. Cylinders or or ranges of cylinders that are in 
use (not entirely available) are not initialized. 


CV = Cylinder Verification 
Verify only those cylinders specified in answer to the CYLINDER NUMBER prompts, except that 
cylinder 0 is always verified. 


RR = Relocate and Reallocate 
This action is only available for B 9494-5, B 9494-10, and B 9484-12 disks. It is used to relocate 
or reallocate (the reverse or undoing of a relocate) a single sector at a time. The sector may be 
in use and its data will be retained intact, whenever possible. When this action is requested, the 
following prompt sequence ensues: 


A SECTOR CAN BE RELOCATED TO A SPARE OR 
REALLOCATED FROM A SPARE 


ENTER <SECTOR ADDRESS> TO RELOCATE, “-” 
<SECTOR ADDRESS> TO REALLOCATE 


WHICH SECTOR (BLANK TO QUIT)? 
Response examples: 


1000 
@0003E8@ 

— 1000 

— @0003E8@ 


The first two examples cause sector 1000 to be relocated; the next two cause it to be reallocated 
if it is found to be relocated. Entering a blank or null input will terminate the RR action and 
La ee eee een wamlana mM A Renee axxrstnkh A — 1 eerhe nhl am Alinatac that tha wrmerncram ghawla nat 
tie piOzgraii, UNICSS PrOgirain SWitei 2 — 1, Wiiti luiaLlls Lat Uie pPrUxidaiit omUUuI Lue 


automatically terminate. 
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FC = Factory Convert 


This action is available only for B 9494-5 and B 9494-10 fixed disks that are in the interlaced format 
written by the factory. The FC function converts the factory Interchange format to the B 1000 
native-mode format and is used only once when the disk is first installed. The prompt sequence will 
ask for the PACK TYPE and OWNER’S NAME. This action cannot be selected and is not offered 
for a disk that is not of the correct type, is formatted as a sequential disk, has an unreadable or inva- 
lid label, or has already had an FC performed on it. 


NOTE | . 
The actions RR, RC, RI, CI, and CV are valid only when processing a disk 
that has previously been initialized with the Mark 8.0 (or later) version of 
the SYSTEM/DISK-INIT or PACK/INIT programs and the disk label, avail- 
able tables, and Relocate Table are intact and valid. 


Initialization Messages 


SER 


IAL NUMBER 

The SERIAL NUMBER message requests a six-digit decimal number to be used on a new or 
purged pack to identify the disk. This number must be non-zero and must be unique to avoid 
confusion. Note that the MCP does not allow two User disks with the same serial number to be 
on-line at the same time. 


Prompt: ENTER 6 DIGIT SERIAL NUMBER 


PACK ID 


The PACK ID message requests a name that is assigned to the disk using 10 or fewer characters 
and containing no embedded blank characters. The system uses this name to reference the disk. 
When input specifications are entered from cards, omitting this entry causes an error for pack- 
type. If the disk is a User disk, the reserved name DISK will not be allowed. 


Prompt: ENTER PACK ID 


PACK TYPE 


The PACK TYPE message requests the type of use that this disk will be dedicated to until the 
next initialization. The type is specified by a one-letter abbreviation of the allowable pack types, 
which are User (U), System (S), or Interchange (I). Only removable disk packs are allowed to be 
initialized as Interchange packs; therefore, the prompt message varies according to the type of disk 
being initialized. 


Prompt: ENTER PACK TYPE — <U OR S> 
(for fixed, non-removable disks) 


Prompt: ENTER PACK TYPE — <U, I OR S> 
(for removable disk packs) 


OWNER’S NAME 
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EXTENDED RESULT 
The extended result descriptor (for disk packs only). If an ecentea result descriptor is present, 
it is shown in hexadecimal on the next line of the Unit Error Report. On the immediately following 
lines, the extended result descriptor is decoded to provide salient information (CYL, HEAD, SEC, 
OP, VXYZ, UNIT, error types). 


Cylinder addresses in the extended result descriptor can appear to be incorrect when TEST 
operations are being performed to a disk drive. This is because a TEST operation has no associ- 
ated cylinder address and the old address does not change. If an exception condition occurs during 
a TEST operation, the exception condition is logged into the SYSTEM/ELOG file when the next 
READ or WRITE operation is initiated. To correctly identify which operation was contained in 
the extended result descriptor, examine the OP column of the line that gives the extended result 
descriptor. 


REEL 
For tape units only, this column gives the reel number on which the error occurred. 


BLOCK 
For tape units only, this column gives the block in which the error occurred. 


Result Descriptor Analysis 


Foliowing the Unit Error Report is the Resuit Descriptor Analysis. This shows the descriptors in both 
hexadecimal and binary format and provides a brief description of the error. Each result descriptor 
is listed once in this report, regardless of the number of times it appears in the Unit Error Report. 


Disk Error Address Analysis 


For disk devices, this follows the Result Descriptor Analysis. Here, the errors are grouped by disk ad- 
dress, sorted in ascending order, and summarized by address and actual data transfer length (in sec- 
tors). Each line represents the errors for a particular disk address and actual length pair, giving the 
total number of retries (retry counts shown as zero in the chronological listing are counted as one 
retry), and decoding the beginning and ending disk addresses involved in the operation into their actual 
hardware locations. This decoding can enable the Burroughs field engineer to locate not only the source 
of the failure, but also to make reasonable inferences as to errors that can be caused by a single 
read/write head, even though the addresses can be widely scattered across an entire disk surface. 
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Power On/Off Error Rate Report 


This report gives snapshots of the error count information logged when a disk is powered on or off. His- 
toric and recent information by unit and pack is given. The total number of input/output (I/O) opera- 
tions as counted by GISMO and the number of I/O errors as recorded by the MCP are reported. The I/O 
error count is incremented by one for each user I/O that has a problem, no matter how many retries are 
done. 


See the ER command in the B 1000 Systems System Software Operation Guide, Volume 1, for informa- 
tion on error rates and on resetting the unit and pack error rate information. 


Following are the meanings of the various fields for the Power On/Off Error Rate Report. 


PWR 
Indicates whether a power ON or OFF caused the line to be generated. 


SERIAL NUMBER 
Serial number of pack at time of power ON or OFF. 


UNIT HISTORIC RESET DATE 
Date the unit was last reset or coldstarted. 


UNIT HISTORIC IO COUNT 
Number of unit I/Os as counted by GISMO since the last unit reset or coldstart. 


UNIT HISTORIC ERROR COUNT 
Number of unit I/O errors as recorded by the MCP since the last unit reset or coldstart. 


UNIT RECENT RESET DATE 
Date the unit was last reset or clear/started. 


UNIT RECENT IO COUNT 
Number of unit I/Os as counted by GISMO since the last unit reset or clear/start. 


UNIT RECENT ERROR COUNT 
Number of unit I/O errors as recorded by the MCP since the last unit reset or clear/start. 


PACK HISTORIC RESET DATE 
Date the pack was last reset or initialized. 


PACK HISTORIC IO COUNT 
Number of pack I/Os as counted by GISMO since the last pack reset or pack initialize. 


PACK HISTORIC ERROR COUNT 
Number of pack I/O errors as recorded by the MCP since the last pack reset or pack initialize. 


PACK RECENT RESET DATE 
Date the pack was last reset or powered ON. 


PACK RECENT IO COUNT 
Number of pack I/Os as counted by GISMO since the last pack reset or pack power ON. 


PACK RECENT ERROR COUNT 
Number of pack I/O errors as recorded by MCP since the last pack reset or pack power ON. 
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Configuration Disk Unit Error Rate Report 


This report gives snapshots of the historic error information by unit based upon information obtained 
at clear/start or when the log is transferred. The I/O operations are counted by GISMO and the I/O 
error count is recorded by the MCP. The I/O error count is incremented by one for each user I/O 
that has a problem, no matter how many retries are done. 


See the ER command in the B 1000 Systems System Software Operati lon Guide, Volume 1, for informa- 
tion on error rates and on resetting the unit and pack error rate information. 


The meaning of the various fields for the CONFIGURATION DISK UNIT ERROR RATE REPORT 
follows: 


PORT 
Hardware port number. 


CHANNEL 
Hardware channel number. 


UNIT 
Hardware unit number. 


CLEARSTART/LOGXFER DATE 
Date of clear/start or log transfer. 


CLEARSTART/LOGXFER TIME 
Approximate time of clear/start or log transfer. 


UNIT HISTORIC RESET DATE 
Date of last reset or coldstart. 


UNIT HISTORIC IO COUNT 
Number of unit I/Os as counted by GISMO since the last unit reset or coldstart. 


UNIT HISTORIC ERROR COUNT 
Number of unit I/O errors as recorded by the MCP since the last reset or coldstart. 


Unit Error Summary 

This report is a summary of the peripheral unit errors listed in the Unit Error Reports. Here, totals 
are given for each unit-mnemonic and, if applicable, for each hardware address. For each device listed, 
counts of input errors (read and space operations), output errors (write operations), and memory access 
errors are presented in tabuiar form. 


The Unit Error Summary also includes cassette error and main memory error counts. 
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Examples of input records in the card file CARD follow: 
US=USERA PW=X CHG=123456 PRI=4 PACK=USERPACK *PRIV 
CHG=1000 PRI=8 US=USERB PW=ME 
US=USERA PW=''"' PACK=USERPACK 
US=SITE PW='"'"'' CHG=999999 PRI=15 *PRIV PUBLIC 
US=USERB PW=PW3 PACK="""' 


Examples of ODT input commands: 


TAXCREATE 

TAX CREATE CARDFILE 

TAXCRE USERDISK/USER/CODEFILE DISK 

TAX CREATE ''' %CREATES DEFAULT USERCODE FILE 


DEBUG Command 


The DEBUG command controls listing of debugging output on the line printer. The command is in- 
and 


i 
tended for system software development d in normal operation. 


‘Syntax: 
-__ DEBUG 
ON , 
L— off ——J 
DELETE Command 
The DELETE command allows removal of existing entries from the (SYSTEM)/USERCODE file. 


Syntax: 


——_DELETE ~ usercode-specifier > 


DEL 


The usercode-specifier is specified in the same manner as is shown for the CHANGE command. The 
"=" option deletes all entries with the specified <usercode>. 


WARNING 
In rare cases, deleting an active usercode can cause the system to halt. Be 
sure that no programs are scheduled or running when deleting a 


neeranda /nacewar | 
USCTCOGE/ password. 


Examples: 
1AXDELETE USER1/PASS1 


1AX DEL USER2/= 
LAXDEL USER3/”" 
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DISPLAY Command 
The DISPLAY command displays the existing (SYSTEM)/USERCODE file on the ODT. 


Syntax: 


__ pispLay a 


L <usercode-specifier > HOSTNAME < identifier > 
Le Ti 
*NONE 


INDEX 
LINKS 


SORTED 
*PRIV 


*NONPRIV 


If no options are specified, the DISPLAY command causes the entire file to be displayed. If the 
<usercode-specifier> is entered, only the specified usercodes are displayed. The use of the *PRIV op- 
tion allows the display of only privileged usercodes. The HOSTNAME option allows usercodes on the 
specified BNA host to be displayed. If the LINKS option is specified, the usercode file is displayed on 
the ODT by usercode index. The SORTED option causes the usercode file to be displayed in alphabeti- 
cal order with the link fields. If the INDEX option is specified, the usercode index is displayed on the 
ODT. The user’s pack name is shown within brackets if the pack override bit is set. The display may be 
interrupted by supplying the SYSTEM/MAKEUSER program with another AC or AX system 
command. 


Example: 
DISPLAY HARRY/= *NONPRIV #Display those usercode/password 


épairs of HARRY which are 
%nonprivileged. 


DISPLAY *PRIV HOSTNAME *ANY “Display only those entries 
‘which are privileged and valid 
from the remote host. 

DIS LINKS SORTED #Display the entire usercode fiie 
%in alphabetical order with the 
élink fields. 


énonpr ivi leged. 
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END/EQJ Command 
The END/EOJ command causes the SYSTEM/MAKEUSER program to go to end of job. 


Syntax: 


a ee ee a | 


-— EOJ ——_——— 
Example: 
2AX END % THIS IS THE SAME AS "EOJ” 
HELP Command 
Displays the list of commands, followed by a list of keywords. 
LIST Command 


The LIST command allows listing of all or part of the existing (SYSTEM)/USERCODE file on the 
line printer. 


Syntax: 


a LIST 


<usercode-specifier > 


HOSTNAME < identifier > 


INDEX 
LINKS 


SORTED 
*PRIV 
*NONPRIV 


If no option is specified with the LIST command, the (SYSTEM)/USERCODE file is sorted by usercode 
and the entire file is listed on the line printer. The <usercode-specifier> option allows the listing of only 
the designated entries. If the LINKS option is specified, the usercode file is listed on the line printer by 
usercode index. The SORTED option causes the usercode file to be listed on the line printer in alphabeti- 
cal order with the link fields. If *PRIV is specified, only the entries for usercodes marked as PRIVI- 
LEGED are listed. Specifying *NONPRIV causes only those usercodes marked NONPRIVILEGED to 
be listed on the line printer. If a usercode family is specified in the LIST command, the usercode family 
can be listed only by usercode index. If INDEX is specified, the actual usercode index is listed. The user’s 
pack name is shown within brackets if the pack override bit is set. 
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The pack-id listed for all usercodes which have the default pack assignment of the system disk is *SYS 
DISK*. 


Examples: 
TAX LIST 
TAXLIS USER1/= 
TAXLIST SITE/PRIV 
TAX LIS USERA/' 


TAXLIST *PRIV 
TAX LIST HOSTNAME HUB~ % Lists only the entries which are 


valid from the remote host called 
HUB. 


eeoe 


1AX LIST REX/= HOST SA} Lists only those entries of REX 
which are valid from the remote 


host SAI. 


dO dO de 


TAX LIST *NONPRIV HOSTNAME USER3 Lists only those entries which are 
nonprivileged and which are valid 


from remote BNA host USER3. 


ee ge adede 


HUB. 
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SECTION 47 
SYSTEM/PACKCOPY 


SYSTEM/PACKCOPY is a normal-state utility program that is used to drive a B 9498 PE tape unit 
in the 100 ips mode for fast backup of User and online System disks. 


OVERVIEW 


Two programs are actually involved in the copy process: SYSTEM/PACKCOPY for the disk I/O oper- 
ations and communication with the operator, and SYSTEM/PACKCOPY-T for the tape I/O. The pro- 
grams use extensive buffering and a direct I/O capability. Direct I/O eliminates the open and close 
operations normally associated with reading and writing files. 


Synopsis of Program Operation 


An operator uses syntax similar to that of the SYSTEM/COPY program to specify the copy parameters. 
The result is a copy of some or all of the files from the input disk to tape. The disk is copied in a file-by- 
file manner; therefore, no penalty is incurred in dumping packs with unused capacity. If the COPY com- 
mand with the COMPARE option is selected, the SYSTEM/PACKCOPY program copies and compares 
the input disk files to the ouypul tape files (including the tape directory file) in a Teel- -by- reel fashion. The 


the same manner ah additional tape reels until all files selected from the input disk are copied and 
compared. Because the output tape is written in the SYSTEM/COPY format, any or all of its files may 
be retrieved by means of the SYSTEM/COPY program. 


Restrictions 


wer 


The SYSTEM/PACKCOPY program is not a substitute for the SYSTEM/COPY program, and does 
not include all of the options or extensive capabilities of that program. It also is not designed to copy 
multipack files or to copy from tape to disk. 


For effective use, the SYSTEM/PACKCOPY program should be the only job in a mix except for 
SYSTEM/ODT. 


Other Considerations 


The SYSTEM/PACKCOPY and SYSTEM/PACKCOPY-T programs use approximately 260K bytes of 
memory including approximately 218K bytes of dynamic memory for data buffers. 


A User pack that is being copied is not available through the MCP for any ate al as If the 
SYSTEM/PACKCOPY program terminates abnormally when copying a User pack, the pack must be 
readied before it can be accessed by the MCP. Abnormal termination of the SYSTEM/PACKCOPY 
program results in termination of the SYSTEM/PACKCOPY-T program. 


A System disk that is being copied is not available for most other purposes, especially library and file 
maintenance fufictions. While a System disk is being copied, the MCP wiii stop aii jobs other than 
SYSTEM/PACKCOPY, SYSTEM/PACKCOPY-T and SYSTEM/ODT. None of the stopped jobs can 
be resumed until the copy of the System disk is finished or SYSTEM/PACKCOPY is aborted. 


This program will not copy any file with a usercode of “(SYSTEM)” because a file of this type could 
not be retrieved by SYSTEM/COPY. Files that are open output and the SYSTEM/LOG, 
SYSTEM/ELOG, SYSTEM/ODTLOG and SYSTEM/ODT__QUEUE files cannot be copied from a 
System disk. 
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OPERATING INSTRUCTIONS 


The command input accepted by SYSTEM/PACKCOPY is a proper subset, except for the addition 
of the <terminate command>, of the B 1000 SYSTEM/COPY syntax (see SYSTEM/PACKCOPY 
Command Syntax in this section). This input may originate from the ODT, using the AC and AX sys- 
tem commands, or from the COMMAND file. 


Command input must consist of one or more complete commands, each separated by a semicolon char- 
acter (;). Each command is completely parsed and executed before the next one is processed. 


ODT Command Input 


When command input originates from the ODT, the maximum size of a single input is 800 characters 
(10 lines). Please note that the <mix-number> AC system command, rather than AX, must be used 
if more than one command is entered at a time, so that the separating semicolon (;) may be used. 
For an explanation of the AC and AX system commands, please refer to the B 1000 Systems System 
Software Operation Guide, Volume 1, section 5. 


If no errors that call for additional command input are encountered, and the AUTO__EOJ switch is 
set to its default setting (SW1 = 0), SYSTEM/PACKCOPY automatically goes to end of job (EOJ) 
after all of the commands in the firsts ODT command input string have been processed. If the 
AUTO__EOJ switch is set to not invoke AUTO__EOJ (SW1 = 1), then the program remains in the 
mix, requesting additional command input, and must be explicitly terminated with a <terminate com- 
mand >. Note that the setting of the AUTO__EOJ switch has no effect when command input originates 
from the COMMAND file. 


COMMAND File Input 


Command input originates from the ODT unless a FILE or MODIFY program control instruction is 
used to change the title of the COMMAND file from COMMAND to some other title. An example 
of the kind of FILE instruction required is as follows: 


FILE COMMAND TITLE PACKCOPY/COMMANDS ON MYDISK; 


When command input originates from the COMMAND file, commands cannot be entered from the 
ODT. The ODT, however, is still used to communicate with the operator. 


The MAXRECSIZE of the COMMAND file is 800 characters; however, it is opened with DEPEN- 
DENTSPECS = TRUE, so that the actual record size may be anything up to 800 characters. 


The format of the COMMAND file is completly free-form, except that an individual token may not 
cross a record boundary. A command is allowed to cross a record boundary, and each command must 
be separated from the next command by a semicolon (;). A percent sign (%) appearing anywhere in 
a record specifies that everything in that record that follows the percent sign is commentary only. 


The input from the COMMAND file is terminated by either a <terminate command> or by end of 


file (EOF), whichever occurs first. The program automatically goes to EOJ when the COMMAND file 
input is terminated. 
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Execution Examples 


The following ODT entry requests that all of the files on the User pack named MYPACK be copied 
and compared to a tape named MYTAPE: 


EX SYSTEM/PACKCOPY;AC COPY AND COMPARE = FROM MYPACK TO 
MYTAPE (KIND=TAPE) ;BYE 


The following is an example of the OD 7 on that might take place for a copy of all of 
the files from a User pack named MYPACK to a tape named MYTAPE: 


EX SYSTEM/PACKCOPY 


SYSTEM/PACKCOPY =7771 BOJ. PP=4, MP=4 TIME = 16:07:26.0 
* SYSTEM/PACKCOPY =7771 ENTER THE NEXT COMMAND, PLEASE. 
SYSTEM/PACKCOPY =7771 ACCEPT. 


7771AC COPY = FROM MYPACK (KIND = DISK) TO MYTAPE (KIND=TAPE) 


SYSTEM/PACKCOPY-T =7772 BOJ. TIME = 16:07:57.8 
% SYSTEM/PACKCOPY =7771 BEGIN: COPY 134 FILES FROM MYPACK (SERIALNO= 
588301) TO MYTAPE (KIND=TAPE) 
SYSTEM/PACKCOPY-T =7772 EOJ. TIME = 16:13:46.5 
% SYSTEM/PACKCOPY =7771 END: COPY 134 FILES FROM MYPACK TO MYTAPE 
(K |ND=TAPE) 
SYSTEM/PACKCOPY =7771 EQJ. TIME = 16:14:46.8 


The following ODT entry, together with the COMMAND file example that follows it, requests that 
some of the files on the System disk be copied and compared to a tape named MYTAPE1, and that 
all of the files on a User disk named MYPACK be copied and compared to a tape named MYTAPE2: 


EX SYSTEM/PACKCOPY;FI COMMAND TITLE ARCHIVE/SYS-DISK ON DISK; 
COMMAND file exampie: 


COPY AND SET (COMPARE, 
DATE = 11/11/84 TO 11/17/84 


) 
(USERCODE) 
» MYFILES/= 
» OTHERFILE/ONE 
, LASTFILE FROM DISK TO MYTAPE1 (KIND=TAPE) ; 


COPY AND COMPARE = FROM MYPACK TO MYTAPE2 (KIND=TAPE) 


STATUS Request 


The status of an executing COPY command is displayed on the ODT when the STATUS command is 
entered. 


Example: 


122AX STATUS 

% SYSTEM/PACKCOPY =122 STATUS: COPY AND COMPARE 100 
FILES FROM MYPACK TO MYTAPE (KIND=TAPE) ~-APPROX. 75% 
COMPLETE--COMPARING FILE #50: A/B ON MYPACK - REEL #3 
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Syntax Errors 

A syntax error encountered while parsing a command causes an error message to be displayed. If the 
command input is coming from the ODT, any pending command input is discarded and the operator 
is asked to enter the next command. When the command input originates from the COMMAND file, 


the operator is prompted to enter NEXT to skip to the next command in the file or EOJ to go to 
end of job. 


A syntax error is displayed on the ODT as follows: 


——-—-> SYNTAX ERROR : <error message> 
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Example: 


EX SYSTEM/PACKCOPY 
SYSTEM/PACKCOPY =114 BOJ. PP=4, MP=4 TIME = 08:18:48.8 


% SYSTEM/PACKCOPY =114 ENTER THE NENT COMMAND, PLEASE 
SYSTEM/PACKCOPY =114 ACCEPT. 


114AC COPY AND COMPARE = FROM MYDISK TO MYTAPE (KIND=DISK) 
% SYSTEM/PACKCOPY =114 ----> SYNTAX ERROR : "TO! <TAPE NAME> 
'(KIND=TAPE) '' REQUIRED 
% SYSTEM/PACKCOPY =114 ENTER THE NEXT COMMAND, PLEASE 
SYSTEM/PACKCOPY =114 ACCEPT. 
114AC COPY AND COMPARE = FROM MYDISK TO MYTAPE (KIND=TAPE) 
Desa aaa T =115 BOJ. PP=5, MP=5 TIME = 08:19:07.6 


4 SYSTEM/PACKCOPY =114 BEGIN: COPY AND COMPARE 134 FILES FROM 
MYDISK (SER! ALNO=140012) TO MYTAPE (KIND=TAPE) 


Execution Errors 


If a problem that can be corrected by the operator is encountered (e.g., PACK CANNOT BE FOUND) 
during the execution of a command, the operator is requested to enter OK, NEXT or NEW if the 
command input is from the ODT. If the command input originates from the COMMAND file, the 
operator is requested to enter OK, NEXT or EOJ. 


OK is used after the problem is corrected. The program makes another attempt to execute the com- 
mand. 


NEXT causes the program to skip to the next command if more than one command was originally 
entered from the ODT or the COMMAND file. 


NEW causes all pending command input to be discarded. The program returns a request for new com- 
mand entry. This entry is prompted only when commands are being entered from the ODT. 


EOJ causes the program to go to end of job. This entry is prompted only when the command input origi- 
nates from the COMMAND file. 


Example: 


114AC COPY = FROM MYDISK TO MYTAPE (KIND=TAPE) 
% SYSTEM/PACKCOPY =114 PACK "MYDISK!' CANNOT BE FOUND 
% SYSTEM/PACKCOPY =114 ENTER "OK" IF PROBLEM FIXED, "NEXT" TO 
PROCESS NEXT COMMAND IN INPUT STRING OR "NEW" TO ENTER 
NEW COMMAND (S) 
RY DPC 
SYSTEM/PACKCOPY =114 ACCEPT, 


114AC OK 


1169091-002 
47-3 


B 1000 Systems System Software Operation Guide, Vol. 2 
SYSTEM/PACKCOPY 


Tape I/O Errors 


The MCP automatically tries to recover from tape errors. It tries up to 10 times to write a given block, 
moving the tape ahead after each try. If the data block cannot be written on tape after 10 tries, a write- 
parity-error-on-tape message is given. The name of the file that was being written at the time of the error 
is also displayed. The SYSTEM/PACKCOPY program then displays a list of the allowable error recov- 
ery options, which may include RETRY, RESTART, NEXT and EOJ. 


If the RETRY option is selected the SYSTEM/PACKCOPY program performs the failing I/O operation 
one more time. It is not offered for most I/O errors because the MCP has already performed extensive 
recovery procedures. When the RETRY option is offered, it is offered continuously by the SYSTEM/ 
PACKCOPY program until the I/O operation is successfully completed or until something other than 
the RETRY option is selected. 


If the RESTART option is selected the SYSTEM/PACKCOPY program rewinds, purges, and locks the 
current tape reel. The following message then appears: ENTER “OK” WHEN A SCRATCH TAPE IS 
READY FOR RESTART. The first ready scratch tape (lowest channel, lowest unit number) is used to 
RESTART the current COPY command at the beginning of the current reel. 


If the NEXT option is selected the SYSTEM/PACKCOPY program aborts the current COPY com- 
mand. If another command is available from the ODT input or the COMMAND file, then that com- 
mand is performed; otherwise, the program automatically goes to end of job. 


If the EOJ option is selected the SYSTEM/PACKCOPY program forces the program to an immediate 
end of job. 


Example: 


SYSTEM/PACKCOPY-T = 
4 SYSTEM/PACKCOPY-T 
RESULT = @D00080@ 
% SYSTEM/PACKCOPY-T =7772 CURRENT FILE 1S DIRECTORY/FILENAME 

% SYSTEM/PACKCOPY =7771 ENTER "RESTART" TO REWRITE 
THE CURRENT REEL, "NEXT" TO PROCESS NEXT COMMAND IN 
INPUT STRING OR "EQJ" 

SYSTEM/PACKCOPY =7771 ACCEPT. 


77] 1AX EQJ 
4 SYSTEM/PACKCOPY =7771 CURRENT COPY TERMINATED 
SYSTEM/PACKCOPY-T =7772 EQJ. TIME = 14:43:25.1 
% SYSTEM/PACKCOPY =7771 END: COPY 23 OF 134 FILES FROM SB TO 
SBT (K1ND=TAPE) 
SYSTEM/PACKCOPY =7771 EOQJ. TIME = 14:43:27.0 


Disk |/O Errors 
The MCP automatically tries to recover from disk errors also. If the disk error is irrecoverable, however, 
the SYSTEM/PACKCOPY program requests entry of CONTINUE, QUIT, NEXT, or EOJ. 


If the error occurs while reading user-file data, entering CONTINUE instructs the program to ignore the 
bad data. The current data block is marked as unreliable and copying continues with the writing of the 
remaining blocks of the file to tape. 


NCOUNTERED A PARITY ERROR ON MTA ON WRITE 


Pie E 
=7772 ** FATAL TAPE ERROR (DATA ERROR), 


If the error occurs while reading a disk directory sector, CONTINUE instructs the program to skip to 
the next directory sector. Copying continues with the next available file in the next directory sector. 


If the error occurs while reading a disk file header, CONTINUE causes the program to skip the associat- 
ed file. No part of the file will be copied. 


A QUIT response is permitted only for errors in user-file data. Q 
t in nt 


a alan atinn: sttan to 


UIT instructs the program to abandon 
the file. A file-abort indication is written in 


ytape an nues with the next file in the directory. 
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The NEXT and EOJ responses have the same meanings as previously described under Tape I/O Errors. 


Example: 


% SYSTEM/PACKCOPY =125 IRRECOVERABLE DISK READ ERROR IN FILE 
DIRECTORY/FILENAME ON MYPACK, SECTORS @O1FADE@ THROUGH @O1FAFB@ 

% SYSTEM/PACKCOPY =125 ENTER "CONTINUE" TO IGNORE THE ERROR, 
"QUIT'' TO ABANDON THE CURRENT FILE, "NEXT" TO PROCESS NEXT 
COMMAND IN INPUT STRING OR "EQJ" 

SYSTEM/PACKCOPY =125 ACCEPT. 


125AX CONTINUE 


SYSTEM/PACKCOPY-T =126 EOQJ. TIME 23:55:34.7 

4 SYSTEM/PACKCOPY =125 END: COPY 10 FILES FROM MYPACK TO 
MYTAPE (KIND=TAPE) 

SYSTEM/PACKCOPY =125 EOJ. TIME 23:55:40.2 


Comparison Errors 


When the COMPARE option is specified, SYSTEM/PACKCOPY compares the input disk files to the 
output tape files in a reel-by-reel manner. In the event of a comparison error, a listing is produced indi- 
cating the name and hardware type of both the source (FROM) and copy (TO) volumes, the name of the 
file currently being compared, the type of tape records being compared, and the contents of those 
records. 


Comparison errors occurring in user-file data records or tape directory entry records are not fatal errors 
and cause the program to request the operator to enter the SKIP, NEXT, or EOJ response. Comparison 
errors occurring in more critical kinds of records, such as tape header records or tape end-of-file records, 
are fatal and the operator is only given a choice of the NEXT or EOJ response. 


The SKIP response, when entered in response to a user-file data comparison error, stops the compare 
process until the end of the current tape file 1s reached, or in the case of a file that crosses reel boundaries, 
the end of the reel. The compare process resumes with the start of the next file, or in the case of a file 
that crosses reel boundaries, the start of the next reel. If the comparison error occurred in a tape directory 
entry record, the SKIP response instructs the program to continue the compare process with the next 
entry. 


The RESTART, NEXT, and EOJ responses have the same meanings as previously described under Tape 
I/O Errors. 


Example: 


% SYSTEM/PACKCOPY-T =298 ** COMPARISON ERROR IN FILE 
DIRECTORY/FILENAME 


% SYSTEM/PACKCOPY =297 ENTER "SKIP" TO SKIP THE CURRENT FILE, 
"RESTART' TO REWRITE THE CURRENT REEL, 
"NEXT' TO PROCESS NEXT COMMAND IN INPUT STRING OR "EQJ" 


297AX SKIP 
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SYSTEM/PACKCOPY COMMAND SYNTAX 


Syntax: 
< copy ee 


< terminate command > ; 


<copy command> 


eee eee file specs. >———_$$_—______> 
<  _Packcopy options > 
>— FROM <input volume spec >——-TO < output volume spec Ss se 


<packcopy options > 


<_spackcopy options > 


| COMPARE 
1 DATE = < date > 


= BEFORE < date > 


AFTER < date 


< date >TO < date 


The DATE option specifies that a file is to be selected for copying only when its update date fulfills 
the conditions specified by the DATE option. Only one DATE option is allowed for each command, 
and it applies to all of the files selected by the following <file specs>. A <date> must be in the 
form mm/dd/yy, and the following values may be specified: 


Value Files Selected 
<date> Files updated on the specified date. 
BEFORE <date> Files updated before the specified date. 
AFTER <date> Files updated after the date. 
<date> TO <date> Files updated between (inclusive of) the 


specified dates. 
Example: 


COPY AND SET(COMPARE, DATE = AFTER 12/3/84) A/= FROM MYDISK TO MYTAPE 
(KIND = TAPE); 
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